PrValidate

Ensure that a TPrint record has valid settings

#include <PrintTraps.h> Printing Manager

THPrint hPrtRec ; handle leading to a TPrint structure

returns Were any fields changed?

PrValidate checks all fields of a specified TPrint record to ensure

compatibility with the printer driver and the currently-active printer. Use

this to verify the integrity of a print record you created on-the-fly or read

from a file. PrStlDialog and PrJobDialog call PrValidate, so you don't

have to worry about calling PrValidate if you call PrStlDialog or

hPrtRec is a handle leading to a 120-byte TPrint structure. Upon return,

its fields have been verified, and if the return value is TRUE, one or

more of those fields have been changed.

Returns: a Boolean; it indicates whether fields of hPrtRec were modified. It

is one of:

FALSE The record was entirely valid.

TRUE One or more fields need to be (and were) changed.

Notes: In the event that certain fields of the TPrint record were not internally

self-consistent, PrValidate will modify these values without indicating it

did so in the return value.

Use PrintDefault if you want to pre-set all fields of hPrtRec to standard

default settings.

Be sure to call PrOpen before calling PrValidate. It is also important

that the printing resource file made current by PrOpen is either the

current resource file, or below the current resource file in the resource

file chain, (see UseResFile for details) so that it can be accessed.

Referenced by (27):